<html>

<head>
	<title>
		API用户手册
	</title>
</head>

<body>

	<a href="packages.html"> Java API</a>
	<h1>Java应用编程接口</h1>
	<h1>用户手册</h1>

	<h2>API的组织方式</h2>

	有以下三个层次：

	<ul>
		<li>所有包
		<li>所有类 (在包中)
		<li>指定类 (最终想要找的类).
	</ul>

	<h3>第1层 —— 所有包</h3>
	这一层提供了关于API 1.0发行版本中的所有包的链接。

	<h3>第2层 —— 指定包</h3>
	这一层提供了关于特定包中的类和接口的链接，由以下列表中的目录项组成：
	<ul>
		<li>接口
		<li>类
		<li>异常
	</ul>

	<h3>第3层 —— 指定类/接口</h3>
	这一层以索引开始，然后紧跟API的细节，由以下三个目录项组成：
	<ul>
		<li>属性
		<li>构造器
		<li>方法
	</ul>
	当类没有适用的条目时，将省略类别。<p>
	在这些类别中，有以下附加颜色编码：
	<dl>
		<dd><img src="images/magenta-ball.gif"> 实例属性
		<dd><img src="images/blue-ball.gif"> 静态属性
		<dd><img src="images/yellow-ball.gif"> 构造器
		<dd><img src="images/red-ball.gif"> 实例方法
		<dd><img src="images/green-ball.gif"> 静态方法
	</dl>

	<h2>如何找到想要的信息</h2>
	<ul>
		<li>浏览一个包的信息
			<menu>
		<li>从所有包的列表中选择一个包进行查看，这个是所有Java API的主页
			</menu>
		<li>寻找一个类
			<menu>
		<li>使用索引进行检索
		<li>或者从它所在的包中寻找
		<li>使用字典索引进行检索
			</menu>
		<li>浏览一个类的信息
			<menu>
		<li>点击上一个/下一个链接可以以字典序进行浏览。
		<li>或者，遍历类中的链接。
			</menu>

		<li>寻找一个方法
			<menu>
		<li>使用索引进行检索
		<li>或者，滚动按字母顺序排列的类索引来查找方法。
			</menu>
	</ul>


	<h3>API详情页面</h3>
	以java.lang包中的类String详情页面为例。导航栏位于顶部。其后是全类名及其类的继承关系示意图。 <p>
	接下来的条目是指向超类和接口（如果有的话）的链接。后面是从类注释中获取的类描述。以及一些使用示例(如果有的话)。
	<p>再下面还会有一个其他参考。 

	<h3>索引</h3>
	每个类/接口以其属性、构造函数和方法的索引开头，按字母顺序排序。条目由声明和简短描述组成。描述是该项目的文档注释的第一句。索引条目链接到紧随其后的应用程序编程界面中的相应条目。<p>

	<h3>API详情</h3>
	索引后面是每个条目的完整API介绍。在属性、构造函数和方法这三个类别中，条目按照它们在源代码中的显示顺序显示。这样做是为了保留程序员建立的逻辑分组。

	<h3>API中所有链接的位置介绍</h3>

	<ul>
		<li>在每个类/接口的顶部都有指向其他层级以及上一个和下一个（类或接口）的导航链接。 
		<li>每个方法和属性定义的类类型中都有链接。
		<li>在每个类/接口的顶部都有一张树结构图，向下延伸到当前类/接口，其中每个超类都是一个链接。 
		<li>每个方法都包含可能引发的异常列表。这些链接到相应的类。 
		<li>类开头的超类和接口引用是链接。
		<li>每个其他参考也是一个链接。 
		<li>当一个方法重写超类中的一个方法时，API具有条目“重写:foo(位于类bar中)”。foo(方法名)和bar(类名)是链接。 
	</ul>

	<hr>
</body>